If you want to track online campaigns, you should add special tags to the campaign links. You can do this manually or use our Piwik PRO URL builder.
In this article, we’ll explain how to do it.
Parameters that you can add
You can use default parameters, which will store your campaign data under specific dimensions. Our Piwik PRO URL builder uses pk_* parameters, but you can also use utm_* parameters if you wish.
Here’s a list of all campaign parameters and the dimensions in which they store campaign data.
| Dimension | Default parameters | Required/Optional | Description |
|---|---|---|---|
| Campaign name | pk_campaign, piwik_campaign, pk_cpn, utm_campaign | Required | The name of your campaign. Example: winter_promo. |
| Source | pk_source, utm_source | Optional | It helps you identify the platform on which you run your campaign, such as a newsletter, social media site or other site. Example: Newsletter, Facebook, Google. |
| Medium | pk_medium, utm_medium | Optional | It helps you identify the method or format of your campaign, such as a banner ad, sponsored post or click-per-click (CPC) ad. Example: banner, sponsored_post, CPC |
| Keyword | pk_keyword, piwik_kwd, pk_kwd, utm_term | Optional | Words or phrases used in paid search campaigns. Example: free_bank_account. |
| Campaign content | pk_content, utm_content | Optional | It helps you separate similar content within the same ad. For example, if you have a newsletter with two call-to-action buttons, you can tag each link for each button with a different pk_content parameter and see which version is working better. |
| Campaign ID | pk_cid, utm_id | Optional | It lets you assign a unique ID to your campaing. For example, if you use two similar creatives on Facebook and want to see which one performs better, you can tag them with different pk_cid parameters. Note: The gclid is passed through this parameter. |
Note:
- Parameter values are case sensitive. The campaign name
winter_promois different fromWinter_Promo. - The parameter value can be up to 1024 characters.
- You can customize the default parameters. Read more
- For best results, you should tag your campaigns with great detail.
How to add parameters
You can add parameters manually or you can use the Piwik PRO URL builder. Let’s look at an example.
If you’re running a winter campaign on Facebook using a sponsored post, you can set the following parameters:
- pk_campaign: winter_promo
- pk_source: Facebook
- pk_medium: sponsored_post
Your campaign URL will look like this:
https://clearbank.com?pk_campaign=winter_promo&pk_source=Facebook&pk_medium=sponsored_postIf someone enters your site from this link, Piwik PRO will recognize these parameters and save your campaign data under the following dimensions:
- Campaign: winter_promo
- Source: Facebook
- Medium: sponsored_post
View data in the campaign report
After setting up your campaigns, you can view data related to the ads in the campaign report.
To see the campaign report, follow these steps:
- Go to Menu > Analytics.
- Navigate to Reports.
- On the left, click Campaigns.
- Done!